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Linux Audio Conference 2013 


Modular sessions 


Some programs, interconnected via: 

► Jack audio 

► Jack Midi 

► Alsa Midi 
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Connection graphs 


Assume a system with 

P port-types, each having 
O p output ports and 
l p input ports. 

The number of all possible connection graphs ft then is 
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ft = 2 5^p=i 


Connection graphs 
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1 audio 

= 40 

audio in 

OMidi 

= 10 

Midi out 
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Session management. 
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. . . is desirable. 


History 


Once upon a time [...] 


LADCCA (2003) 

Linux Audio Developers Configuration and Connection API 
https://savannah.nongnu.org/proj ects/ladcca 

superseded by 


LASH (2005) 

Linux Audio Session Handler 

https://savannah.nongnu.org/projects/lash 
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which is still alive. 


JACK Session 


http://trac.j ackaudio.org/wiki/WalkThrough/User/j ack_session 


£3 Load... Recent » U Save ▼ S Versioning (5 Refresh 


Client / Ports UUID Command 



Frontends: 

► pyjacksm 

► QjackCtl 

► and . . . 
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In QjackCtl, non-compliant applications can be 
added as “Infra-clients”. 


















LADISH 


Linux Audio Desktop Integration Session Handler 
http://ladish.org 



LASH's successor, 
incorporates both LASH 
and JACK Session. 

Frontend: 

► patchage 


Non-compliant applications can be 
added as “Level 0-clients". 
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NSM 

Non Session Manager 

http: //non. tuxf amily. org/wiki/Non’/,20Session"/,20Manager 


Refresh Open Close Abort 

Save New Duplicate 

Sessions 

foo 

bar 

Add Client to Session 

foo 



JACKPatch ■ save ready 


Non-DAW ■ save ready 


Non-Mixer ■ save ready 


Non-Sequencer ■ save ready 


yoshimi ■ save [ launch ] 


NSM Proxy (japa -J) ■ GUI SAVE ready 



Ea Enter executable name 


OK Cancel 

Got announce from NSM Proxy 


Chino 

David Adler 

Introduction 
Modular sessions 

Session management 

Concepts 
Presets and sessions 
Applications and 
Methods 
Dependencies 

Implementation 
Steps and tasks 
User interface 

Miscellaneous 

Demo 

Q&A 


Applications not supporting the protocol can be 
added as “NSM Proxy-clients”. 




Chino vs. the others 



others 

Chino 

any connection graph 

yes 

no 

any application 

no 1 

2 

yes'" 

central saving point 

yes 

no 

preparation required 

no 

yes 

GUI 

yes 

no 
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1 LADISH, Qjackctl and NSM allow to include non-compliant 
applications. 

2 lf the application is sufficiently scriptable. 
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Presets and sessions 


Chino 


Chino does nothing, 
the preset does it all, 
the preset is just another session. 
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Templates, inheritance of files 

David Adler 
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session B 
















Applications 
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Methods 

Categories of similar applications, defined via 
method libraries. 


Method types: 

unique methods channel methods 
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Method types, methods and applications 
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Method IDs and application IDs 
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method types 


methods 


applications 




























Application files 


are kept in <application_ID> directories below the 
session’s base directory. 


Presets must contain all application files. 

Sessions will contain the ones they (ever) require(d). 
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Libraries 


Chino 


are kept in a libs directory below the session’s base 
directory. 


Presets must contain all libraries. 
Sessions may optionally hold libraries. 
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A ” root-library”, called <session_name>-listlib, holds a 
list of all allowed methods and applications. 


Inheritance of libraries 
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program + use case => dependencies 
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Dependencies 
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Dependencies - port-groups 
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Steps 
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► assign 

► check 

► list 

► copy 

► start 

► acn 
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► men 

► the “tweak-and-save loop” (not a step) 

► unassign or kill 


Tasks 

A Task is a series of steps accomplishing something useful.. . 


application 

step 

al 

a2 

a3 

a4 

assign 





check 





list 





copy 





start 





acn 





men 





unassign 





kill 






Chino 

David Adler 

Introduction 
Modular sessions 
Session management 

Concepts 
Presets and sessions 
Applications and 
Methods 
Dependencies 

Implementation 
Steps and tasks 

User interface 

Miscellaneous 

Demo 

Q&A 


















Tasks 
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. . . like restarting an application... 
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. . . re-establishing all audio connections. . . 
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Tasks 

... or starting an entire session. 
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Step functions 


Chino 


Chino executes a step by calling a corresponding function 
( “step function") from the method library. 
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Step functions 


# Step-functions in a method library. 

# 

# Naming: 

# s_<method ID>_<step name> 

# the assign step 

s_ch_synth_assign() 

{ 

# some stuff 

} 

# the check step 

s_ch_synth_check() 

{ 

# some stuff 

} 
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Steps - helper functions 


Chino 

David Adler 


Inside a method’s step function, usually a helper function is 
called that will accomplish the step in a standardised way. 
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Steps - usage of helper functions 

# Helper-functions, prefixed h_, called by 

# the corresponding step-functions. 

# 

# Naming: 

# h_<step name> 

s_uq_msc_check() 

i 

declare -ri i=$l 

COPY_uq_msc[i] ="$(h_check uq_msc $i)" 

echo "== COPY_uq_msc[$i] ${COPY_uq_msc[i]}" 

} 

s_uq_msc_list() 

{ 

declare -ri i=$l 
h_list uq_msc $i 
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h_assign() and h_copy() 


h_assign() sources the application library, thereby 
implementing inheritance rules for libraries. 


h_copy() copies the application files, thereby 
implementing inheritance rules for application files. 

If the application requires it, h_copy() will call 
<application_ID>_move(). 
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h.start () 


Chino 


h_start() calls: 

► a function <application_ID>_start () from the 
application library to start the program; 

► Assign functions in which we must assign ports to 
variables, in accordance with the method’s and 
application's depends and provides. 
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h.start () 




h_start() - assign-functions 


APR0_CH_effect= ’EFFECT’ 

ADEP_CH_effect= ’EFFBUS’ 

# The method ch_effect has audio depends/provides, 

# so an assign-function for audio is required. 

ch_effect_ja_assign() 

{ 

declare -ri chan=$l 
declare -r inports=$2 
declare -r outports=$3 

EFFECT_AIN_L[chan] =$(echo "$inports" I sed -n lp) 
EFFECT_AIN_R[chan] =$(echo "$inports" I sed -n 2p) 
EFFECT_AOUT_L[chan] =$(echo "$outports" I sed -n lp) 
EFFECT_AOUT_R[chan] =$(echo "$outports" I sed -n 2p) 
echo "== EFFECT_AIN_L[$chan] ${EFFECT_AIN_L [chan]}" 
echo "== EFFECT_AIN_R[$chan] ${EFFECT_AIN_R[chan]}" 
echo "== EFFECT_AOUT_L[$chan] ${EFFECT_AOUT_L[chan]} 
echo "== EFFECT_AOUT_R[$chan] ${EFFECT_AOUT_R[chan]} 


h_acn() and h_mcn() 


Chino 


h_acn() and h_mcn() call connect-functions in which we 
must establish connections, one for each of the method’s 
and application's depends. 
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h_acn() 





h_acn() - connect-functions 


ADEP_ch_effect= ’EFFBUS’ 

# The method ch_effect depends on EFFBUS, so a 

# corresponding audio connect-function required. 

ch_effect_acn_EFFBUS() 

{ 

declare -ri chan=$l 

# inputs from send ports 
declare -i i=0 

while [ $i -It $MIXER_NCHAN ] ; do 

msaudioconnect EFFBUS_SEND "$chan,$i" EFFECT_AIN $chan 

(( i++ )) 

done 

# outputs to return ports 

msaudioconnect EFFECT_AOUT $chan EFFBUS_RETURN $chan 

} 


Chino 


msaudioconnect HW_A0UT 0 MX_AIN 14 

will, depending on existance of port-variables, connect: 

${HW_A0UT_L) --- ${MX_AINJt[14] } 

${HW_AOUTJRj -- ${MX_AIN_L [14] } 


${HW_A0UT} 


_ _ __ ${MX_AIN_R[14] } 

--• ${MX_AIN_L [14] } 


${HW_A0UT_L} 

${MX_AINJt} 


${MX_AIN [14] } 


${HW_A0UT} 


${MX_AIN [14] } 
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${HW_A0UT_L} 


${MX_AIN_R[14] } 








h_mcn() 




h_mcn() - connect-functions 


MDEP_chef_jackrack= ’CC’ 

# The application chef_jackrack depends on CC, so a 

# corresponding Midi connect-function is required. 

chef _j ackrack_mcn_CC() 

{ 

declare -ri chan=$l 

ajmidiconnect CC_M0UT 0 chef_jackrack_MIN $chan 

} 


Chino 


ajmidiconnect SEQ_M0UT 4 SYNTH.MIN 4 

will, depending on existance of port-variables, connect: 


${SEQ_M0UT_J [4] } •- 

-. ${SYNTH_MIN_J [4] } 

${SEQ_M0UT_A [4] } • 

• ${SYNTH_MIN_A [4] } 

${SEQ_M0UT_J [4] } • 


${SEQ_M0UT_A [4] } .- 

-. ${SYNTH_MIN_A [4] } 

a2jmidid «.- 

-• ${SYNTH_MIN_J [4] } 

${SYNTH_MIN_A [4] } i 


SEQ_M0UT_J [4] •- 

-« a2jmidid 


• ${SYNTH_MIN_A [4] } 
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Keeping the graph intact 


Chino 


Connect-functions aren’t exclusively called by 
h_acn() and h_mcn(). 

E.g. the task for starting an application will call 
connect-functions of nodes depending on any newly provided 
port-group. 
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User interface 


Chino 


David Adler 


► command line options and arguments 

► runtime user interface 

► the session definition file 
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User interface - command line 


[fooObar ~]$ chino -h 

chino -h 
chino -v 

chino -w [-p <ppath>:<pname> -t <tpath>:<tname] 
chino -m [-p <ppath>:<pname> -t <tpath>:<tname] 
chino -a [-p <ppath>:<pname> -t <tpath>:<tname] 
chino -n name [-p <ppath>:<pname> -t <tpath>:<tname>] 
chino -o sdef 


-h 

-v 

-w 

-m 

-a 

-n <name> 

-o <sdef> 

-p <ppath>:<pname> 
-t <tpath>:<tname> 


display this help text 
print version number 

write session definition file prototype 

create new method library 

create new application library 

start new session with name <name> 

open session using session definition file <sdef> 

Use preset <pname> in directory <ppath> as preset, 
overriding the default from ~/.chinorc. 

Use session <tname> in directory <tpath> as template. 
If not specified, the preset will serve as template. 



User interface - at runtime 


Chino 


M - add a method 
A - add an application 
X - remove an application 
R - restart an application 

localise application/method library 
: - localise all used libraries 

f - force sourcing of application/method library 

1 - list current session 

d - check dependency tree 
g - toggle session graph display 
w - write changes to session definition file 

a - redo audio connections 
m - redo midi connections 

s - store connection snapshot 
r - restore connection snapshot 
u - un-store connection snapshot 
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User interface - session definition file 

David Adler 


NAME=opus2 

PRESET=/usr /share/chino/presets/default:default 
TMPL= 

# methods and applications 

UQMETHS=hw msc meter 
uq_hw=stereo 

uq_msc=ardour2 vkeybd nonseq 
uq_meter=jkmeter japa 

CHMETHS=synth 

ch_synth-CH-001=yoshimi 

ch_synth-CH-002= 

ch_synth-CH-003= 

ch_synth-CH-004= 

ch_synth-CH-005= 

ch_synth-CH-006= 

ch_synth-CH-007= 

ch_synth-CH-008= 
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Over the network? ssh! 

Chino 


David Adler 

Portability 

Introduction 


Modular sessions 

► self-contained or shared preset 

Session management 


Concepts 

► program versions 

Presets and sessions 
Applications and 

► hardware requirements 

Methods 

Dependencies 

► sampling rates 

Implementation 

Steps and tasks 

User interface 

► local configuration files 

Miscellaneous 

► external (audio)files 

Demo 

The Future 

Q&A 

► application groups 

► guided fixing of unresolved depends 

► have a preset determine window placement for 
applications—via scriptable WM 

► text-only sessions in git 



Thanks to 


Chino 


David Adler 


► LAD, LAU and the wider Linux audio community, for all 
that software and the reading matter they provide. 

► http://tuxfamily.org for their friendly no-BS 
hosting. 
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http://chino.tuxfamily.org 


david.jo.adler@gmail.com 


